home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1998 April: Mac OS SDK / Dev.CD Apr 98 SDK1.toast / Development Kits (Disc 1) / Interfaces&Libraries / Universal / Interfaces / PInterfaces / DriverFamilyMatching.p < prev    next >
Encoding:
Text File  |  1998-02-12  |  5.7 KB  |  184 lines  |  [TEXT/MPS ]
  1. {
  2.      File:        DriverFamilyMatching.p
  3.  
  4.      Contains:    Interfaces for create native drivers NDRV
  5.  
  6.      Version:    Technology:    
  7.                  Release:    Universal Interfaces 3.1
  8.  
  9.      Copyright:    © 1995-1998 by Apple Computer, Inc., all rights reserved.
  10.  
  11.      Bugs?:        Please include the the file and version information (from above) with
  12.                  the problem description.  Developers belonging to one of the Apple
  13.                  developer programs can submit bug reports to:
  14.  
  15.                      devsupport@apple.com
  16.  
  17. }
  18. {$IFC UNDEFINED UsingIncludes}
  19. {$SETC UsingIncludes := 0}
  20. {$ENDC}
  21.  
  22. {$IFC NOT UsingIncludes}
  23.  UNIT DriverFamilyMatching;
  24.  INTERFACE
  25. {$ENDC}
  26.  
  27. {$IFC UNDEFINED __DRIVERFAMILYMATCHING__}
  28. {$SETC __DRIVERFAMILYMATCHING__ := 1}
  29.  
  30. {$I+}
  31. {$SETC DriverFamilyMatchingIncludes := UsingIncludes}
  32. {$SETC UsingIncludes := 1}
  33.  
  34. {$IFC UNDEFINED __MACTYPES__}
  35. {$I MacTypes.p}
  36. {$ENDC}
  37. {$IFC UNDEFINED __NAMEREGISTRY__}
  38. {$I NameRegistry.p}
  39. {$ENDC}
  40. {$IFC UNDEFINED __CODEFRAGMENTS__}
  41. {$I CodeFragments.p}
  42. {$ENDC}
  43.  
  44.  
  45. {$PUSH}
  46. {$ALIGN MAC68K}
  47. {$LibExport+}
  48.  
  49. {
  50.   ##############################################
  51.    Well known properties in the Name Registry
  52.   ##############################################
  53. }
  54. { CPassThru }
  55. {
  56.   #########################################################
  57.    Descriptor for Drivers and NDRVs
  58.   #########################################################
  59. }
  60. { 
  61.     QuickTime 3.0: "DriverType" has a name collision with cross-platform code.
  62.     Use Mac prefix to avoid collision 
  63. }
  64. { Driver Typing Information Used to Match Drivers With Devices }
  65.  
  66. TYPE
  67.     MacDriverTypePtr = ^MacDriverType;
  68.     MacDriverType = RECORD
  69.         nameInfoStr:            Str31;                                    {  Driver Name/Info String }
  70.         version:                NumVersion;                                {  Driver Version Number }
  71.     END;
  72.  
  73. {$IFC TARGET_OS_MAC }
  74.     DriverType                            = MacDriverType;
  75.     DriverTypePtr                         = ^DriverType;
  76. {$ENDC}  {TARGET_OS_MAC}
  77.  
  78. { OS Runtime Information Used to Setup and Maintain a Driver's Runtime Environment }
  79.     RuntimeOptions                        = OptionBits;
  80.  
  81. CONST
  82.     kDriverIsLoadedUponDiscovery = $00000001;                    {  auto-load driver when discovered }
  83.     kDriverIsOpenedUponLoad        = $00000002;                    {  auto-open driver when loaded }
  84.     kDriverIsUnderExpertControl    = $00000004;                    {  I/O expert handles loads/opens }
  85.     kDriverIsConcurrent            = $00000008;                    {  supports concurrent requests }
  86.     kDriverQueuesIOPB            = $00000010;                    {  device manager doesn't queue IOPB }
  87.     kDriverIsLoadedAtBoot        = $00000020;                    {  Driver is loaded at the boot time  }
  88.     kDriverIsForVirtualDevice    = $00000040;                    {  Driver is for a virtual Device  }
  89.     kDriverSupportDMSuspendAndResume = $00000080;                {  Driver supports Device Manager Suspend and Resume command  }
  90.  
  91.  
  92. TYPE
  93.     DriverOSRuntimePtr = ^DriverOSRuntime;
  94.     DriverOSRuntime = RECORD
  95.         driverRuntime:            RuntimeOptions;                            {  Options for OS Runtime }
  96.         driverName:                Str31;                                    {  Driver's name to the OS }
  97.         driverDescReserved:        ARRAY [0..7] OF UInt32;                    {  Reserved area }
  98.     END;
  99.  
  100. { OS Service Information Used To Declare What APIs a Driver Supports }
  101.     ServiceCount                        = UInt32;
  102.     DriverServiceInfoPtr = ^DriverServiceInfo;
  103.     DriverServiceInfo = RECORD
  104.         serviceCategory:        OSType;                                    {  Service Category Name }
  105.         serviceType:            OSType;                                    {  Type within Category }
  106.         serviceVersion:            NumVersion;                                {  Version of service }
  107.     END;
  108.  
  109.     DriverOSServicePtr = ^DriverOSService;
  110.     DriverOSService = RECORD
  111.         nServices:                ServiceCount;                            {  Number of Services Supported }
  112.         service:                ARRAY [0..0] OF DriverServiceInfo;        {  The List of Services (at least one) }
  113.     END;
  114.  
  115. { Categories }
  116.  
  117. CONST
  118.     kServiceCategoryDisplay        = 'disp';                        {  Display Manager }
  119.     kServiceCategoryOpenTransport = 'otan';                        {  Open Transport }
  120.     kServiceCategoryBlockStorage = 'blok';                        {  Block Storage }
  121.     kServiceCategoryNdrvDriver    = 'ndrv';                        {  Generic Native Driver }
  122.     kServiceCategoryScsiSIM        = 'scsi';                        {  SCSI  }
  123.     kServiceCategoryFileManager    = 'file';                        {  File Manager  }
  124.     kServiceCategoryIDE            = 'ide-';                        {  ide  }
  125.     kServiceCategoryADB            = 'adb-';                        {  adb  }
  126.     kServiceCategoryPCI            = 'pci-';                        {  pci bus  }
  127.                                                                 {  Nu Bus  }
  128.     kServiceCategoryDFM            = 'dfm-';                        {  DFM  }
  129.     kServiceCategoryMotherBoard    = 'mrbd';                        {  mother Board  }
  130.     kServiceCategoryKeyboard    = 'kybd';                        {  Keyboard  }
  131.     kServiceCategoryPointing    = 'poit';                        {  Pointing  }
  132.     kServiceCategoryRTC            = 'rtc-';                        {  RTC  }
  133.     kServiceCategoryNVRAM        = 'nram';                        {  NVRAM  }
  134.     kServiceCategorySound        = 'sond';                        {  Sound (1/3/96 MCS)  }
  135.     kServiceCategoryPowerMgt    = 'pgmt';                        {  Power Management  }
  136.     kServiceCategoryGeneric        = 'genr';                        {  Generic Service Category to receive general Events  }
  137.  
  138. { Ndrv ServiceCategory Types }
  139.     kNdrvTypeIsGeneric            = 'genr';                        {  generic }
  140.     kNdrvTypeIsVideo            = 'vido';                        {  video }
  141.     kNdrvTypeIsBlockStorage        = 'blok';                        {  block storage }
  142.     kNdrvTypeIsNetworking        = 'netw';                        {  networking }
  143.     kNdrvTypeIsSerial            = 'serl';                        {  serial }
  144.     kNdrvTypeIsParallel            = 'parl';                        {  parallel  }
  145.     kNdrvTypeIsSound            = 'sond';                        {  sound }
  146.     kNdrvTypeIsBusBridge        = 'brdg';
  147.  
  148.  
  149. TYPE
  150.     DriverDescVersion                    = UInt32;
  151. {    The Driver Description }
  152.  
  153. CONST
  154.     kInitialDriverDescriptor    = 0;
  155.     kVersionOneDriverDescriptor    = 1;
  156.  
  157.     kTheDescriptionSignature    = 'mtej';
  158.     kDriverDescriptionSignature    = 'pdes';
  159.  
  160.  
  161.  
  162. TYPE
  163.     DriverDescriptionPtr = ^DriverDescription;
  164.     DriverDescription = RECORD
  165.         driverDescSignature:    OSType;                                    {  Signature field of this structure }
  166.         driverDescVersion:        DriverDescVersion;                        {  Version of this data structure }
  167.         driverType:                MacDriverType;                            {  Type of Driver }
  168.         driverOSRuntimeInfo:    DriverOSRuntime;                        {  OS Runtime Requirements of Driver }
  169.         driverServices:            DriverOSService;                        {  Apple Service API Membership }
  170.     END;
  171.  
  172.  
  173.  
  174. {$ALIGN RESET}
  175. {$POP}
  176.  
  177. {$SETC UsingIncludes := DriverFamilyMatchingIncludes}
  178.  
  179. {$ENDC} {__DRIVERFAMILYMATCHING__}
  180.  
  181. {$IFC NOT UsingIncludes}
  182.  END.
  183. {$ENDC}
  184.